Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / tmjr21.arc / TMJR21.TXT < prev

Wrap

Text File | 1986-06-10 | 17.8 KB | 347 lines

IMPORTANT: IF YOU HAVE USED VERSION 2.0 (OR EARLIER) OF TMODEMJR THE TMODEM.CNF FILES ARE NOT COMPATABLE. PLEASE ERASE THE OLD FILE AND ALLOW TMJR21 TO CREATE A NEW ONE. SORRY. TMODEM-JR VERSION 2.0 -- A modification of Tmodem version 1.7 for the IBM-PCjr with INTERNAL modem ONLY ----------------------------------------------------------------- THIS IS THE ORIGINAL INTRODUCTION TO TMODEM VERSION 1.7 WHICH IS THE SOURCE FOR THE JR MODIFICATION. ----------------------------------------------------------------- Documentation for TMODEM TMODEM is short for Turbo Modem. A communications program for IBM Personal Computers and compatible units. TMODEM is supplied with source code in Turbo PASCAL version 3.00B, the user is encouraged to customize this code as he wishes, but he must not remove, bypass, or alter the copyright notice presented by the program. The author, Paul Meiners, and his company, P & M Software, reserve the copyright to this program and all related materials. The user is granted a license to use the program and is encouraged to make a donation if the program is found to be useful. $10 is recommended. Send donations to the following address: P & M Software Company 9350 Country Creek #30 Houston, Texas 77036 In addition, the user is granted the right to make unlimited copies of the program and to distribute these copies as he desires, except that the author reserves the sole right to distribute the program for profit. The user may ask for a duplication charge, not to exceed $5 per copy. Why distribute another modem program? There are plenty of them around, commercial, user supported and public domain. Answer: To make available customizable code, as PC-TALK did, but in a classier language, PASCAL. Our hope is that people will become exposed to PASCAL and will support it in a serious manner, the way BASIC has been supported. ----------------------------------------------- Jr Modifications Tmodem has been modified for the IBM-PCjr by: Alan C. Fusco 2307 Benderwirt Avenue Rockford, Illinois 61103 CIS 74726,1316 Please write or send a Cis-EasyPlex if you have any problems or suggestions for future modifications. This program was modified because I was frustrated with the available communication programs for the PCjr with its internal modem. I wanted both XMODEM and CIS-B (or A) transfers in one program, as well as auto dial, capture to memory and full jr compatibility. Nothing was on the market that handled these requirements and I was really getting tried of using one program for RBBS and another for CIS. When I saw Tmodem I realized the potential this program had and being a Pascal programmer I dove into making various modifications for jr. I also added some enhancements that I wanted in a communication program. Please note that I didn't write either the XMODEM or CIS B transfer protocols, I just added some commands to get them to work with jr. The CIS B protocol was written by Jim Nutt (71076,1434) and downloaded from Borland International Sig on Compuserve (GO BOR-100). Please give him a hearty thanks for making this protocol available in Turbo Pascal in a "generic form". Please DO NOT send me a donation for this program. The major structure and ideals stem from Paul Meiners at P & M Software Company. If you like the program send me a message to that effect, but send Meiners the donation he has requested. When you send your donation, tell him you are using the jr modification written by Alan C. Fusco. Thank you. ------------------------------------------------------------------ TMODEM-JR Features: {* indicates either additions or modifications that I have made to the program} 1. TTY emulation. *2. OMITTED-- ANSI.SYS style color graphics. *3. OMITTED--BASIC style PLAY for single voice music. {I have deleted all code for ANSI c/g and music to increase capture buffer memory on a 128K jr and to decrease communication costs (color and music capabilities, while nice, increase communication costs).} 4. Fully buffered, interrupt driven, serial I/O. 5. XMODEM file transfer-- * internal modem compatible uploads & downloads. 6. Removable window subsystem. 7. Telephone directory, with up to 999 entries. 8. File capture, limited only by the amount of available memory-- * memory toggle shows memory remaining on lower left of command line. 9. ASCII file transmission, using XON/XOFF protocol. 10. Disk handling routines: view a file, kill a file, list directory, and change logon drive 11. Full control of all communication parameters. 12. 40 macro keys, to store logon, passwords, etc. *13. Compuserve CIS B file transfers (upload & download). The code for this protocol was written by Jim Nutt CIS- 71076,1434. Only minor modifications were made to his code to allow uploads with jr. *14. Zippy dial-- allows dialing a number without displaying the directory. *15. Elapsed connect time indicator (toggle) in lower right hand corner of command line. *16. Linefeed toggle and echo toggle *17. Program configuration installation module-- allows changing of modem commands, window and text colors. *18. Modification of redial to work with jr. *19. Bell sound when CONNECT is made. Most of the features of the program are self-documenting, however for the sake of the novice user, some explanation is necessary. The program is distributed in .COM form. The .COM version can be executed immediately by placing your disk into drive A, changing the default drive to A, if not already, then typing the name of the program, TMjr. Once the user has successfully executed the program, the copy- right notice will appear. The on-line screen will then appear. At the bottom of the online screen appears a command line containing a reminder of the most frequently used commands as well as elapsed time since a CONNECT has been established and the amount of memory remaining if buffer Capture is on. If the user needs a command that does not appear on the screen, a complete list of available commands can be obtained by selecting HOME. Commands may be selected while the HELP screen is still on screen, so that the user does not need to call up the HELP screen repetitively. Here is a brief description of each command: ** NOTE: I have extensively modified the command sequence used. ALT-A .... Transmit a file using the ASCII XON/XOFF protocol, where the DC1 character is used for XON and the DC3 character is used for XOFF. ALT-C .... Turn capture mode ON if it is OFF, or OFF if it is ON. When this mode is turned OFF, either thru the ALT-C command or with the END command, the user will be prompted for a file name wherein to save the contents of the capture buffer. During capture mode operations, a '*' or 'W' will appear in the lower left corner of screen. The '*' reminds the user the capture mode is ON, the 'W' warns the user that memory space is short. Capture mode will make use of all available memory. On a 128K jr the size of the capture buffer will vary from 17 to 19K depending on the number of files open with the FILES= command. If both capture toggle and capture mode are on the amount of memory remaining will be shown. A save is automatically called for when less than 5K remains. At this time the code does not support appending to a file, so be sure to give each file a different name. ALT-D .... Modem dialing and phone directory management. The phone directory may have up to 999 entries, if there is enough disk space. The directory screen will automatically disappear whenever carrier is detected. ALT-E .... Turns echo on or off. If you get double letters try this toggle. It may work. NOTE: This feature has not been tested. Default state is off. ALT-F .... Toggles linefeed on/off. Default state is off. Use this toggle if lines keep writing over each other on you screen. ALT-H .... Hangs up the modem using ^N H command. ALT-I .... Reconfigure the program defaults contained in the .CNF file. ALT-K .... Macro Key management. Allows the user to define the contents of the function keys F1 thru F10, and all combinations of the function keys and shift, Ctrl or Alt. This gives the user 40 macro keys. ALT-L .... List the disk directory. A user mask can be supplied. ALT-M .... Toggles memory remaining display on/off. ALT-N .... Allows the user to change to a new logged drive and/or new current directory. ALT-P .... Allows the user to change communication parameters. Only parameters supported by the Internal modem are allowed. ALT-R .... Redial the modem. Redialing using the jr's ^N R command and will redial up to 10 times at a rate of one every 40 seconds. ALT-S .... Sort the dialing directory into ascending sequence. Performs and IN MEMORY sort, so there must be enough memory to hold all the phone directory entries. ALT-T .... Toggles the timer display (lower right hand corner of the command line) on or off. The timer runs only if a CONNECT has been detected. The default state is on. If this display bothers you just toggle it off. One note about the timer-- it only works in the main communications window. If any other windows are down, such as xmodem transmit/receive, cis b, etc. the timer will freeze. Once the window is removed the timer will show the correct time. ALT-U .... Turn Half Duplex On if it is OFF, or OFF if it is on. If Half Duplex is On, then a 'H' will appear in the lower right corner of the screen to remind the user. ALT-V .... View the contents of a files, uses the same style as MORE, the DOS utility. ^C stops the command. ALT-W .... Wipes the screen clear. ALT-Y .... Delete a file from the disk. ALT-Z .... Zippy dial. This feature allows you to dial a number without having to list the dial directory (ALT-D). You just enter the directory number (not phone number) and hit return. WARNING: The dial directory must be on the disk and the number used must exist. PgDn .... Receive a file using XMODEM protocol. You must be sure that your communications parameters are 8 bits, 1 stopbit & no parity. The amount of time elapsed during the transfer as well as the number of errors received are given. PgUp .... Transmit a file using XMODEM protocol. You must be sure that your communications parameters are 8 bits, 1 stopbit & no parity. The amount of time elapsed during the transfer as well as the number of errors received are given. This command will automatically set the modem to Transparent mode using ^N T 0. HOME .... Produces the HELP screen for the user. END .... Terminate and return to DOS. This command will hang up the modem if communications are still in progress. The dialing management sub-section has the following list of commands: A = Add an entry to the dialing directory. R = Revise an entry in the dialing directory. M = Manual-- Dials a number not in the directory. D = Dials a number from the directory and automatically sets any new communication parameters. S = Stop the modem before it goes online. F = Page Forward-- Displays the next page of the directory. B = Page Backward-- Displays the previous page of the directory. Q = Quit, returns to the online screen. Compuserve CIS B Transfer Protocol. CIS B protocol is automatically started when TMODEMjr intercepts a special character sent by CIS to begin the transfer. TMODEMjr will tell you when this character is intercepted and CIS mode is on. When asked by CIS what transfer protocol you want answer CIS B. You then follow the prompts CIS will give you, everything else is done for you. TMODEMjr will then tell you if the transfer was successful or not and will return control to you. Currently there is no way to stop a transfer once it has begun. In addition, the elapsed time indicator will not run during the transfer. Perhaps in future versions of the program these problems will be resolved. ------------------------------------------------------------------- TMODEM-JR VERSION 2.1 ADDITIONS 9/7/85 ------------------------------------------------------------------- Changing communications parameters: Version 2.0 was buggy when it came to changing communications either from the dialing directory or the ALT-P command. Many times the parameters would not be changed and sometimes the modem would even "hang-up" and refuse to work. I didn't notice this as 99% of my communications are done at 8,n,1. Many thanks to Jeffery C. Kreinbring for pointing out this problem. It is now corrected. Communications parameters will be changed from either the ALT-P command or by dialing any directory number. You should notice 1 or 2 "OK" symbols on your screen showing you that the new parameters are in effect. Dialing numbers from the directory that do not have different parameters will also show 1 or 2 "OK" symbols. Dialing Directory: The S(top) command has been deleted. File Transfers: In version 2.0 after a file transfer was made you had to manually "press any key" to continue. Version 2.1 automatically sounds an alarm when done and removes the file transfer window much like qmodem. Log-On: Tmodem now sounds an alarm after a successful CONNECT is established. Saving Capture Buffer: A default disk file has been set-up for the capture buffer called CAPTURE.TXT. The name can be changed from the configuration window (ALT-I). Everytime you save the contents of the capture buffer it will automatically be appended to the end of CAPTURE.TXT, thus you can now "toggle" the capture on/off to capture only the information you want. In version 2.0 you had to create a separate file each time you open/closed the buffer. The new proceedure is even faster. Configuration File (ALT-I) The configuration file now allows you to create a default name for saving the capture buffer contents (see above). Thus TMODEM.CNF for version 2.0 and 2.1 are NOT compatable. If you have been using version 2.0 erase TMODEM.CNF before running version 2.1. A new configuration file will be created. Tmodemjr can have multiple files open at anyone time. You do not have to close the capture buffer to download a file. If you are having problems with the program crashing it is probably because you have not told you computer to set up enough files. Create the following file: COPY CON:CONFIG.SYS FILES=16 ^Z Then reboot the system. ALT-I .... Reconfigure the program defaults contained in the .CNF file. ALT-K ....